home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / telecomm / 309 / dualterm / dualterm.doc < prev    next >
Text File  |  1988-11-27  |  9KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.                              DualTerm Instruction Manual
  6.                                   by Tony L Belding
  7.  
  8.           INTRODUCTION:
  9.  
  10.                When I bought my 520ST several years ago, I received a
  11.           terminal program with it called ST-TALK.  It did the job, but I
  12.           was disappointed to find that it would not display the ATASCII
  13.           graphics used on Atari 400/800 and XL/XE computers.  Since then I
  14.           have upgraded to newer and more advanced terminals, but none
  15.           offered ATASCII graphics.  Finally I got my hands on GFA Basic 3,
  16.           a programming language so powerful that I could undertake to write
  17.           my very own ATASCII graphics terminal.
  18.  
  19.                The bulk of the code for DualTerm was written in my spare
  20.           time over the course of a single weekend.  Credit for the speed of
  21.           development must go to GFA BASIC, not to me.  Since then I have
  22.           refined DualTerm and added the features needed to make a truly
  23.           practical terminal program.  DualTerm will now do everything a
  24.           terminal needs to do, such as text capture or upload, Xmodem
  25.           upload/download, automatic dialing, and display of both VT52 and
  26.           ATASCII graphics.  At this point I don't plan to add anything
  27.           else, but you, the user, may feel free to add anything you wish.
  28.           DualTerm is entirely public domain.
  29.  
  30.           SETUP:
  31.  
  32.                The file "DIAL.DIR" is needed for the auto-dialer and should
  33.           be kept in the same directory as the program.  "TRANSFER.ACC" and
  34.           "TRANSFER.RSC" should be kept in the root directory of your bootup
  35.           disk.  These files are needed for Xmodem transfer.  Ideally, the
  36.           GFA Basic run-only interpreter should be installed as an
  37.           application in the root directory of the DualTerm disk.  This will
  38.           allow the program to be run simply by double-clicking on
  39.           'DUALTERM.BAS'.  If DualTerm is not run in this way, it may have
  40.           trouble locating the dial directory.  (I am hoping for the GFA
  41.           Basic 3 compiler real soon!)
  42.  
  43.                Before using DualTerm for the first time, you should change
  44.           the default settings to the values you prefer.  To do this, enter
  45.           DualTerm and press HELP to get the main menu.  Then select 'Edit
  46.           Directory' from the 'Dialer' menu.  A screen will appear with a
  47.           listing of services that can be edited.  At the bottom of the
  48.           screen is an entry '>>>> EDIT DEFAULT SETTINGS <<<<'.  You should
  49.           select this with the mouse.
  50.  
  51.                The first setting is the default drive path.  This should be
  52.           the path name of the disk drive or directory that you plan to use
  53.           mainly for uploading or downloading.  DualTerm uses the GEM file
  54.           selector for these functions, so the default path is just a matter
  55.           of convenience.  (By the way: I highly recommend FSELV60.PRG, the
  56.           public domain replacement for the GEM file selector.)
  57.  
  58.                The second setting is the default dial command.  For Hayes-
  59.           compatible modems, this will be ATDP or ATDT.  If your phone uses
  60.           pulse dialing, enter ATDP here.  For tone dialing use ATDT.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.                After entering the dial command, you should find yourself
  72.           back at the editor menu.  Just select '>>>> EXIT EDITOR <<<<' to
  73.           exit and save your new settings.
  74.  
  75.           OPERATION:
  76.  
  77.                While using DualTerm, you can press the HELP key to access
  78.           the main menu bar.  This also shows a summary of the keyboard
  79.           commands.  Here, in more detail, are the commands and how they
  80.           work.
  81.  
  82.           HELP (left mouse key)  = call up the menu and command list
  83.  
  84.           The first 'Atari' drop-down menu allows you to select desk
  85.           accessories.  A transfer accessory is used to upload or download
  86.           files.  The control panel can also be accessed, but will NOT
  87.           change the terminal screen colors.
  88.  
  89.           Calling the menu screen also shows a list of keyboard commands
  90.           that can be used from the terminal itself.
  91.  
  92.           UNDO = exit DualTerm
  93.  
  94.           You will asked to confirm that you wish to leave the program.  If
  95.           a capture file is open, it will be saved and closed before
  96.           returning to the desktop.
  97.  
  98.           CLR/HOME = clear screen
  99.  
  100.           Clears the screen and resets the cursor to the upper left corner.
  101.  
  102.           F1 = toggle ATASCII inverse text mode
  103.  
  104.           When inverse mode is on, you can enter inverse text into the
  105.           ATASCII terminal.  Press F1 a second time to resume normal
  106.           operation.  This key has no effect on the VT52 terminal.
  107.  
  108.           F9 & F10 = type text macro number 1 or 2
  109.  
  110.           The dial directory editor allows you to store two text macros with
  111.           each dial directory entry.  These macros can be fed into the
  112.           terminal at any time by pressing F9 or F10.  These macros are most
  113.           commonly used to store log-on information such as names and
  114.           passwords.  They will work with both VT52 and ATASCII.
  115.  
  116.           ALT-RETURN = force ascii carriage return & linefeed
  117.  
  118.           Most Hayes-compatible modems will not accept AT commands from the
  119.           ATASCII terminal because of the different value for a carriage
  120.           return.  If you want to use an AT command from the ATASCII
  121.           terminal, follow the command line with ALT-RETURN to force the
  122.           modem to accept it.  This is unnecessary with the VT52 terminal.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.           ALT-C = toggle capture on or off
  138.  
  139.           After opening a capture file, this command directs data into the
  140.           capture buffer.  By turning the capture on or off during an online
  141.           session, you can choose which data will be saved into the buffer.
  142.           When the buffer is full, the data is automatically saved to the
  143.           file previously opened with ALT-O, and the buffer is made ready to
  144.           receive more data.
  145.  
  146.           Auto-Dial = call up dial directory
  147.  
  148.           The dial directory of up to 40 services will be displayed on the
  149.           screen.  Use the mouse to select the service you want to call, or
  150.           select '>>>> CANCEL AUTO-DIAL <<<<' to return to the main menu.
  151.  
  152.           Edit Directory = edit the dial directory
  153.  
  154.           The dial directory editor menu will appear.  Use the mouse to
  155.           select the service you want to edit.  You may also choose to view
  156.           or change the default settings.  When you are finished editing,
  157.           select '>>>> EXIT EDITOR <<<<' to save the new directory and
  158.           return to the main menu.
  159.  
  160.           Capture File: OPEN/CLOSED = open or close a capture file
  161.  
  162.           Before capturing text a file must be opened with this command.  A
  163.           file selector will appear, allowing you to enter the desired path
  164.           and filename.  This command does NOT begin capturing text: it just
  165.           get the file ready to receive data.  If a file is already open,
  166.           this command will save the capture buffer to disk and close the
  167.           file.
  168.  
  169.           Duplex: FULL/HALF = toggle duplex
  170.  
  171.           This command manually switches between full and half duplex.
  172.           Duplex is also set automatically by the dial directory when auto-
  173.           dialing.
  174.  
  175.           Terminal: ATASCII/VT52 = change translation mode
  176.  
  177.           This command switches between the 80-column VT52 terminal and the
  178.           40-column ATASCII terminal.  You can also switch instantly between
  179.           the two mode by pressing ALT-T from the terminal.
  180.  
  181.           Upload Text
  182.  
  183.           A file selector appears, allowing you to select the file to
  184.           upload.  The file can be either ASCII or ATASCII: DualTerm doesn't
  185.           care which.  The upload can be aborted at any time by pressing
  186.           CTRL-C.  At 300 or 1200 baud the display may continue for a time
  187.           after aborting because of the ST's built-in buffers.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.           ABOUT THE TRANSFER ACCESSORY:
  204.  
  205.                I did not write it.  Although DualTerm is public domain,
  206.           TRANSFER.ACC is shareware, and contains a note to that effect.  It
  207.           is by no means the only transfer accessory that DualTerm could
  208.           use, but it is the best I have seen so far.  Feel free to test any
  209.           others you may find.
  210.  
  211.           FINAL NOTE:
  212.  
  213.                This documentation should be more extensive, but there isn't
  214.           really a lot to say about DualTerm: it is deliberately simple.
  215.           Also, I must admit that I'm a better programmer than documentation
  216.           writer.  If you have any problems with the program, just contact
  217.           me through the Golden Gate BBS: it is listed in the dial
  218.           directory.
  219.  
  220.                                         - Tony Belding
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.